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Key concepts in this unit 


¢ HTTP: Hypertext Transfer Protocol: a protocol used to transfer data 
over the World Wide Web. 


JAR: Java ARChive: a compressed package file format used to 
aggregate many Java class files and resources into one file for 
distribution. 


JavaBeans: classes that encapsulate many objects into a single 
object (bean). 

SOAP: Simple Object Access Protocol: Messaging protocol 
specification for exchanging information over web services. 


URI: Uniform Resource Identifier: identifies a resource on a computer 
network 


° WSDL: Web Service Definition Language: XML format for describing 
the functionality offered by a web service. 
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Unit objectives 


e Explain how to build services in IBM Business Automation Workflow to 
integrate with external systems 


° Describe the outbound web service and the most common issues that 
generate connection complexities 


e Use the System Data toolkit services when other solutions for external 
system connection are needed 


* Create an inbound web service integration 
* Create an event-based undercover agent 
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After completing this unit, you should be able to: 

« — Explain how to build integration services in IBM Business Automation Workflow 

« Describe the outbound web service integrations and the most common issues that 
generate connection complexities 

« Employ System Toolkit Integration Services when other solutions for external system 
connection are needed 

« Create an inbound web service integration 

* Create an event-based undercover agent 
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Topics 


* Building outbound integrations 
* System toolkit services 
¢ Building inbound integrations 
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Building outbound 
integrations 
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Building an outbound integration 


° Most outbound integrations (connection with external systems) can be 
modeled with the artifacts that are found in the IBM Process Designer 
service library palette 
= Both the Java and web service integration components can be found here 
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Most outbound integrations, or connection with external systems can be modeled with the 
artifacts that are found in the Process Designer service modeler library palette. Both the Java and 
web service integration components can be found there. There are many integration services 
included in IBM BAW, and one of them should be able to accomplish your integration needs 
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Integration types 


° To accomplish the appropriate integration with an external web service, 
it is important to have a good understanding of the process 
implementation requirements 
= Try the built-in services first (web service integration). For the supported 

WSDLs, it is remarkably quick and easy 
= Ifa particular WSDL is not supported or more control is needed over a 
particular request, try the Call WebService via SOAP service 


= If all else fails, create a Java connection of your own that uses either SOAP 
or HTTP protocols 
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When you are ready to connect an external system, start by creating a service flow. On 
the service flow palette, you find a web service connector and a Java connector to 
accomplish your integration. During the upcoming exercise, you use the WSDL discovery 
method. The alternative is to use the Java connection options by using custom JAR files 
that are created with the custom Java connector class. Understand that all integration 


connections are Java connections, so the Java option allows for custom connection types 
when needed. 
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Java integration 


¢ All integration connections are Java connections, so the Java option 
allows for custom connection types when needed 

e Any static API available in Java can be accessed with a Java integration 
that is based on your Java connector class 


= Services that are based on a Java component require a Java class found in 
custom-built Java connectors to work 
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Any static API available in Java can be accessed with a Java integration that is based on your 
Java connector class, as it provides great flexibility. Services that are based on a Java 
component require a Java class found in custom-built Java connectors to work. 


The Java connector allows you to use a custom JAR file that is contained in a process application 
as a managed file, or inside a linked toolkit. JAR files are versioned just like other assets in the 
process application or toolkit and are installed alongside the model when installing a process 
application to a server. If the Java classes are later updated, the version can be updated, and the 
classes are refreshed in a controlled manner to ensure that developers control the governance 
over the upgrade path. Developers can test the new JAR file and avoid regression errors in the 
existing process application. 


Check the Translate JavaBeans check box if you want the result of the serialized Java method 
to return to the service as an XML element. The content of the element is based on the properties 
of the object class. When you check the Translate JavaBeans check box, the variable type that 
you select in the service for the value that is returned from the Java method must be XMLElement 
or ANY. 
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Web service integration 


e An outbound integration 
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An outbound integration is accomplished through an integration connection that accesses a 
SOAP web service. Use the service flow when integrating to an external system. The web service 
integration provides a Web Services Description Language (WSDL) Uniform Resource Identifier 
(URI) discovery feature that automatically lists all the advertised WSDL operations. 


The advantage of the WSDL connection is the discovery of available operations. This feature 
allows developers to create variable types for each operation automatically. The disadvantage is 
that not all WSDL definitions can be read properly. SOAP messages are exchanged in a 
request/response format. When the system sends a request to a web service, the web service 
returns the requested values. These values are specified ina SOAP message, which is a block of 
XML code that contains several elements. 


For Protected WSDL authentication, you can check the Protected WSDL check box in the 
implementation properties for the web service integration component, and then provide the user 
name and password in the provided fields. 
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Connecting to a web service 


Consider: 

° If the WSDL Discovery does not work, test for WS-I compliance first 

° If the WSDL Discovery does not pull back the operations that are 
needed to match the business requirement, test the endpoint with a 
third-party tool like SOAP UI 

° If you require Protected WSDL security, ensure that the web service has 
the right connection settings 


° If endpoints change depending on the different environments 
(development and production), use an environment variable to store the 
WSDL URI and all the other settings that change between environments 
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Here are some items to consider when the web service integration does not work. The first step is 
to check WS-I 1.1 compliance with a third-party software package like Soap UI. IBM support asks 
whether the endpoint passed this test, so you should test this compliance check first. 
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System toolkit services 
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System toolkit services 

A number of prebuilt services are provided in the system toolkit. Search through the service 
options for unique SOAP or HTTP protocol services. Special connections of this type are initiated 
through the system toolkit implementation library. 

The SOAP service type generation or automatic mapping from XML to business objects does not 
occur when you use this approach. You must create the variables manually from the published 
WSDL. 

The System Data toolkit also includes a service for dealing with HTTP called Read from HTTP. 
The HTTP service is also a Java integration component that uses Java classes and HTTP 
methods to invoke the connection and return the data in a structured form such as REST. 
Guidelines (1 of 2) 


Here are some guidelines for using the different custom services. 

If you do not know the endpoint URL at run time, or it changes depending on which environment 
you are using, the custom SOAP service is a good choice. If you need complete control of all the 
parameters in both directions, use the SOAP service. The SOAP service allows you to define 
your own header. 

You might also consider creating a toolkit for these services if they are commonly used across 
your process applications. 

Again, the biggest disadvantage to these services is that they require manual configuration of all 
the options and manual creation of the business objects. 

Guidelines (2 of 2) 


As you can see, there are many advantages to the HTTP service. If your endpoint does not use 
SOAP, then you would start here. You can use this integration with SOAP, but the SOAP service 
is a little easier to use. 

Again, you see that the disadvantage of this service is the manual configuration and creation of 
variables. 

Building inbound integrations 


IBM Business automation Worklflow can publish web services in the same way that it connects to 
web services. Using a SOAP connection, external applications can call the IBM Business 
automation Worklflow web service to initiate a particular process, service, or set of services. 
Creating an inbound web service is similar to creating any other artifact in the library, but when a 
message is received, the system must react. Sometimes the message is intended to run a simple 
service, or return some process data. Many times the inbound messages are intended to affect 
the flow of a process. You can affect the flow by associating the inbound web service with a UCA 
and a receive message event on a process. 

Inbound web services are not always required to use a UCA. To affect a process, use a UCA with 
a message start event or a message intermediate event on a process. 

Event-based undercover agents (UCA) 


Undercover agents (UCAs) are a feature of IBM Business Automation Workflow that can be 
complicated to understand. To simplify, a UCA is a listener that waits to receive a message from 
an event. A message might trigger these events, which is an on-event schedule type or event- 
based UCA, or they might be triggered on a specific schedule (time based). When a UCA is 
triggered, it can start a service in response to the event, and that service defines the inputs and 
outputs for the UCA. You also can define the inputs and outputs of the UCA by using a variable 
implementation if the variable must not change when the UCA receives the message — this is also 
referred to as a pass-through implementation. 

Unit Summary 
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You have now completed this unit. 
Having completed this unit, you should be able to: 
« Explain how to build integration services in IBM Business Automation Workflow 
* Describe the outbound web service integrations and the most common issues that 
generate connection complexities 
« Employ System Toolkit Integration Services when other solutions for external system 
connection are needed 
* Create an inbound web service integration 
* Create an event-based undercover agent 
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